<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-type" content="text/html; charset=utf-8" />
<title>animate(params,options)</title>
<meta name="keywords" content="jQuery 1.2 API Reference,Visual jQuery 1.2,jQuery doc,jQuery API,jQuery,jQuery 1.2 API 参考文档中文版,中文版" />
<meta name="description" content="jQuery 1.2 API 文档中文版，提供最新版 jQuery 开发帮助。" />
<link rel="stylesheet" type="text/css" href="../../style/jqueryapi.css" />
<script type="text/javascript" src="../../style/lib/jquery126.js"></script>
 </script>
<script type="text/javascript" src="../../style/jqueryapi.js"></script>
<link rel="shortcut icon" href="../../style/img/favicon.ico" />
</head>
<body>
<div id="topnav">
		<a href="http://www.jQuery.com/" title="jQuery官网" target="_blank" class="topnav">jQuery官网</a>
	<span class="topnav">|</span>
	<a href="http://jquery.org.cn/" title="jQuery中文网站" target="_blank" class="topnav">jQuery中文网站</a>
	<span class="topnav">|</span>
	<a href="http://www.cn-cuckoo.com/" title="1.1版译者" target="_blank" class="topnav">为之漫笔</a>
	<span class="topnav">|</span>
	<a href="http://shawphy.com/" title="1.2版翻译整理者" target="_blank" class="topnav">Shawphy</a>
    <span class="topnav">|</span>
	<a href="http://www.51toria.cn" title="CHM文档制作者:一揪" target="_blank" class="topnav">CHM文档制作者</a> 
	<span class="topnav">|</span>
	<a href="http://dl.getdropbox.com/u/81097/jQueryAPI_CHM.CHM" title="" target="_blank" class="topnav">CHM最新版本下载</a> 
</div>
<hr style="color:#595959;" />

<div class="content">
				<h1>animate(params,options)</h1>
				<div class="desc"><div>用于创建自定义动画的函数。</div> <div class="longdesc">这个函数的关键在于指定动画形式及结果样式属性对象。这个对象中每个属性都表示一个可以变化的样式属性（如“height”、“top”或“opacity”）。<p>注意：所有指定的属性必须用骆驼形式，比如用marginLeft代替margin-left. </p><p>而每个属性的值表示这个样式属性到多少时动画结束。如果是一个数值，样式属性就会从当前的值渐变到指定的值。如果使用的是“hide”、“show”或“toggle”这样的字符串值，则会为该属性调用默认的动画形式。</p><p>在 jQuery 1.2 中，你可以使用 em 和 % 单位。另外，在 jQuery 1.2 中，你可以通过在属性值前面指定 "<em>+=</em>" 或 "<em>-=</em>" 来让元素做相对运动。</p></div></div><hr />
				<div class="desc"><div>A function for making your own, custom animations.</div> <div class="longdesc">The key aspect of this function is the object of style properties that will be animated, and to what end. Each key within the object represents a style property that will also be animated (for example: "height", "top", or "opacity"). <p>Note that properties should be specified using camel case eg. marginLeft instead of margin-left. </p>The value associated with the key represents to what end the property will be animated. If a number is provided as the value, then the style property will be transitioned from its current state to that new number. Otherwise if the string "hide", "show", or "toggle" is provided, a default animation will be constructed for that property.</div></div>
				<h2>返回值</h2>
				<p class="indent">jQuery</p>
				<h2>参数</h2>
				<p class="indent"><strong>params </strong>(Options) : 一组包含作为动画属性和终值的样式属性和及其值的集合</p>
				<p class="indent"><strong>options </strong>(Options) : 一组包含动画选项的值的集合。</p>
				<h2>选项</h2>
				<p class="indent"><strong>duration </strong>(String,Number) : (默认值: "normal") 三种预定速度之一的字符串("slow", "normal", or "fast")或表示动画时长的毫秒数值(如：1000)</p>
				<p class="indent"><strong>easing </strong>(String) : (默认值: "swing") 要使用的擦除效果的名称(需要插件支持).默认jQuery提供"linear" 和 "swing".</p>
				<p class="indent"><strong>complete </strong>(Function) : 在动画完成时执行的函数</p>
				<p class="indent"><strong>step </strong>(Callback) : </p>
				<p class="indent"><strong>queue </strong>(Boolean) : (默认值: true) 设定为false将使此动画不进入动画队列 (jQuery 1.2中新增)</p>
				<h2>示例</h2>
				<p class="indent">
					第一个按钮按了之后展示了不在队列中的动画。在div扩展到90%的同时也在增加字体，一旦字体改变完毕后，边框的动画才开始。
				</p><p>
					第二个按钮按了之后就是一个传统的链式动画，即等前一个动画完成后，后一个动画才会开始.
				</p>
				<p class="indent"><strong>HTML 代码:</strong></p>
				<div class="code">
					&lt;button id="go1"&gt;» Animate Block1&lt;/button&gt;<br/>
&lt;button id="go2"&gt;» Animate Block2&lt;/button&gt;<br/>
&lt;div id="block1"&gt;Block1&lt;/div&gt;&lt;div id="block2"&gt;Block2&lt;/div&gt; 
				</div>
				<p class="indent"><strong>jQuery 代码:</strong></p>
				<div class="code">
					$("#go1").click(function(){<br/>
&nbsp; $("#block1").animate( { width: "90%"}, { queue: false, duration: 5000 } )<br/>
&nbsp;&nbsp;&nbsp;&nbsp; .animate( { fontSize: '10em' } , 1000 )<br/>
&nbsp;&nbsp;&nbsp;&nbsp; .animate( { borderWidth: 5 }, 1000);<br/>
});<br/>
<br/>
$("#go2").click(function(){<br/>
&nbsp; $("#block2").animate( { width: "90%"}, 1000 )<br/>
&nbsp;&nbsp;&nbsp;&nbsp; .animate( { fontSize: '10em' } , 1000 )<br/>
&nbsp;&nbsp;&nbsp;&nbsp; .animate( { borderWidth: 5 }, 1000);<br/>
});
				</div>
				<hr />
				<p class="indent">
					用600毫秒切换段落的高度和透明度
				</p>
				<p class="indent"><strong>jQuery 代码:</strong></p>
				<div class="code">
					$("p").animate({<br/>
&nbsp;&nbsp; height: 'toggle', opacity: 'toggle'<br/>
&nbsp;}, { duration: "slow" });
				</div>
				<hr />
				<p class="indent">
					用500毫秒将段落移到left为50的地方并且完全清晰显示出来（透明度为1） 
				</p>
				<p class="indent"><strong>jQuery 代码:</strong></p>
				<div class="code">
					$("p").animate({<br/>
&nbsp;&nbsp; left: 50, opacity: 'show'<br/>
&nbsp;}, { duration: 500 });<br/>
				</div>
				<hr />
				<p class="indent">
					一个使用“easein”函数提供不同动画样式的例子。只有使用了插件来提供这个“easein”函数，这个参数才起作用。
				</p>
				<p class="indent"><strong>jQuery 代码:</strong></p>
				<div class="code">
					$("p").animate({<br/>
&nbsp;&nbsp; opacity: 'show'<br/>
&nbsp;}, { duration: "slow", easing: "easein" });
				</div><p class="indent" style="text-align:center;">本手册由<a href="www.51toria.cn">一揪</a>整理编辑,并保持长期更新,最新版本请自行查找</p>
</div>

</body>
</html>
